home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / access / maxs11.exe / MAXESS.TXT < prev    next >
Text File  |  1994-06-24  |  35KB  |  761 lines

  1.                               
  2.      ===============================================
  3.      |           M A X E S S  Lite 1.1             |
  4.      |                                             |
  5.      |     Copyright (C) June 1994, HelgaSoft      |
  6.      ===============================================
  7.           Last updated 06/24/1994
  8.  
  9.  
  10.    Table of contents
  11. 1. Overview
  12. 2. Installation and Test run
  13. 3. Setup/Maintenance
  14. 4. Menus
  15. 5. Table queries
  16. 6. Security
  17. 7. Runtime errors
  18. 8. Limitations and recommendations
  19. 9. Differences between Lite and Retail versions of Maxess
  20. 10. Future enhancements
  21. 11. License and warranty
  22. 12. Ordering and support
  23. Appendix A. Phone Monitor program
  24.  
  25.  
  26.  
  27. 1. OVERVIEW
  28.  
  29.    Maxess 1.1 is a communication utility for Microsoft Access.
  30.    It combines the power of the Access SQL engine with the superior
  31.    communication capabilities of Procomm+ for Windows.
  32.    Maxess users can remotely browse Access tables, conduct multi-field
  33.    queries, send/receive files and messages to/from other users. 
  34.  
  35.    Maxess might be considered as an integration of a BBS (Bulletin Board
  36.    System) with an on-line database.  The next version of Maxess will
  37.    include also remote record update in Access tables.
  38.    Security codes are assigned to all users allowing them to view or 
  39.    search selected tables and fields from the host Access database.
  40.    These codes also determine the user's access to file areas and his
  41.    ability to upload/download files.
  42.    Maxess interface is character-based, remote users do not need an
  43.    additional Windows client program to connect to the host.  The only
  44.    requirement for them is to have a computer and a modem with
  45.    communication software.
  46.    The search capabilities of Maxess make it suitable for a wide range of
  47.    applications - 24 hours remote inventory/price/order monitoring,
  48.    automated customer support, document retrieval, catalog and reservation
  49.    systems, etc.  
  50.    
  51.    Requirements
  52.    Hardware : IBM PC 386 (or compatible), hard disk, VGA monitor, modem(s)
  53.    Software : MS-Windows 3.1 or higher
  54.               MS-Access 1.1 or higher
  55.               Procomm Plus for Windows 1.00 or higher (Datastorm)
  56.  
  57.  
  58. 2. INSTALLATION AND TEST RUN
  59.  
  60.    Maxess integrates two software packages - MS Access and Procomm Plus.
  61.    The installation consists of four simple procedures:
  62.    Step 1 creates a storage place for Maxess files, Step 2 is the
  63.    decompression, Step 3 is the Procomm+ part of the installation and
  64.    Step 4 is the installation in Access.
  65.  
  66. Step 1:  Create a new directory (like C:\MAXESS) on your hard disk
  67.  
  68. Step 2:  Copy the self-extracting file MAXESS.EXE in the new directory
  69.          and run it.  The following files will be created:
  70.  
  71.         MAXESSIN.WAX - Maxess installation Procomm+ script
  72.         MAXESS.WAX   - Maxess main executable Procomm+ script
  73.         MAXESSF.WAX  - file subsystem script (called by MAXESS.WAX)
  74.         MAXESS.INI   - initialization (parameter) file for MAXESS.WAX
  75.         MAXESS.MDA   - MS-Access library with service functions
  76.         MAXESS.TXT   - This file
  77.         MBBSUSER.DOC - Help file for Maxess BBS users
  78.         MAXESS.ICO   - icon
  79.         MAXESS.XXX   - user news file (optional: rename to .NWS)
  80.         MAXESSPM.XXX - phone monitor program (optional: rename to .WAX)
  81.  
  82.    rem: The last two files are intentionally renamed with extension XXX.
  83.         They are optional and might be used if their original names
  84.         are restored.  For more info on MAXESSPM see Appendix A.
  85.  
  86. Step 3:  Start Procomm Plus for Windows.  Run <maxess-path>MAXESSIN.WAX.
  87.          You will be asked to enter several setup parameters (see below).
  88.          The program tries to update MSACCESS.INI (or MSACC20.INI) in the
  89.          Windows directory.  Two lines are added:
  90.  
  91.          section [Libraries]
  92.          <maxess-path>\MAXESS.MDA=ro
  93.  
  94.          section [Menu Add-Ins]
  95.          &MaxessInstall==Maxess_Install("<maxess-path>\MAXESS.INI")
  96.  
  97. Step 4:  Start Microsoft Access and open the database you will be using
  98.          with Maxess.  Maxess relies on the DDE capabilities of Access.
  99.          To make sure DDE is enabled, do the following in Access:
  100.          - from the menu bar select View -> Options -> General
  101.          - verify and set, if necessary:
  102.               Ignore DDE requests   = NO
  103.               OLE/DDE timeout (sec) = 30
  104.          - click on Help (or File/Add-Ins in Access 2.0).
  105.            Select "Maxess Install" from the pull-down menu.
  106.            Five Maxess service tables will be created automatically in
  107.            your database.  Confirm all subsequent prompts, if any.
  108.  
  109. Test Run: The five service tables created in Step 4 contain sample
  110.           records.  They can be used to test-run Maxess.  From the
  111.           Script menu option in Procomm+ select "Run.." then enter
  112.           <maxess-path> MAXESS.WAX .
  113.           The Maxess main window will be displayed with 3 buttons: 
  114.           Stop, View-Log-File and Local-Login.  Click on Local-Login,
  115.           then input "WWW" as username and "WWWW" as password.
  116.           The Maxess Main Menu appears, allowing you to test all
  117.           commands except file transfer.  Local-Login is used to
  118.           simulate remote activity with the system.
  119.       Use the Stop button to halt Maxess.
  120.  
  121.  
  122.  MAXESSIN Parameters (Step 3):
  123.  
  124.  Welcome Message - this will be the initial greeting message of your BBS
  125.  
  126.  Upload Directory - this will be the directory reserved for user file
  127.     uploads.  Enter the full directory path starting with the drive
  128.     letter.  The disk drive must have at least 200KB free storage space
  129.  
  130.  Database filename - enter the filename (full directory path) of the
  131.     Access database you will be using with Maxess
  132.  
  133.  Seconds per day - this is the time limit for daily usage of MAXESS in
  134.     seconds regardless of the user security code
  135.  
  136.  Seconds idle wait - this is the time Maxess will wait for a character
  137.     to be typed at the remote (user) site.  If no character is received
  138.     during this time, a warning message will be send to the user. 
  139.     He will have to respond in one minute, or be disconnected.
  140.  
  141.  Max File NoXfer - a security code equal or greater than the number
  142.     specified here will allow the user to upload/download files.
  143.     Lower security codes disallow file transfer.
  144.     By setting the value to 32700 - the max security code, you can
  145.     disable file transfer for all users
  146.  
  147.   rem: All parameter values are stored in the MAXESS.INI file and
  148.        can be easily modified later with MAXESSIN or a text editor
  149.        like Notepad.
  150.  
  151.  
  152. 3. SETUP/MAINTENANCE
  153.  
  154.   During Maxess installation, the five service tables are filled with
  155.   sample records.  They serve as example and also allow immediate testing
  156.   of Maxess functions.  However, in order to prepare your own system,
  157.   these records have to be deleted.  The explanations below show how to
  158.   set up your own tables and perform the maintenance of your BBS.
  159.  
  160.  3.1  Table Users:
  161.  -----------------
  162.    You may start with an empty Users table the first time you run Maxess.
  163.    New users will fill in their own personal data during normal
  164.    registration.  There is an exception - "SYSOP" is a reserved username
  165.    and can be entered only directly in table Users, not through Maxess.
  166.    Usually, after a new user record has been created, the sysop might
  167.    want to modify 3 fields - Security (dflt=0), Picture (dflt="PictFile")
  168.    and DExp (dflt=30 days after DReg).
  169.  
  170.    Security - used in Lite only to determine file transfer privilege
  171.         see section "Security"
  172.  
  173.    Picture - if the user is authorized to upload his own picture, the
  174.         sysop could transfer it to a special "pictures" directory.
  175.         Then he can enter the full filename in the field Picture of the 
  176.         user's record.  The next time the user calls, his picture will
  177.         appear in the main Maxess window.
  178.         IMPORTANT: Only bitmap (.BMP) picture files are accepted
  179.  
  180.    DExp - the expiration date is set automatically to 30 days after the
  181.         date of registration.  It might be changed to a different date at
  182.         any time
  183.  
  184.  
  185.  3.2  Table TableList:
  186.  ---------------------
  187.     The service table TableList determines which tables from your
  188.     database will be accessible to Maxess users.  Tables not defined
  189.     in TableList will be inaccessible to the remote user.
  190.  
  191.   Security: this field corresponds to field "Security" from table Users.
  192.     Not used in Lite, see section "Security"
  193.  
  194.   TableName:
  195.     This string has to correspond exactly to a table name from your
  196.     database.
  197.  
  198.   PrnStr:
  199.     When a table query is performed, the records found have to be
  200.     displayed on the user's monitor.  In PrnStr you can select which
  201.     record fields to be displayed and in what order.  The field names
  202.     in Prnstr are separated by commas.  Field names with spaces have
  203.     to be enclosed in square brackets (ex. [Weather Forecast] ).
  204.     Prnstr defines also the query output format, see "Query output".
  205.  
  206.   WidStr:
  207.     Here are defined the display widths of all fields from PrnStr.
  208.     The field widths should be listed in the same order as the fields
  209.     in PrnStr, separated by commas.  The total is a sum of all field
  210.     widths plus the number of fields (field columns are followed by one
  211.     space).  The recommended total is 80 chars, maximal is 132.
  212.  
  213.   HidStr:
  214.     This is the list of the hidden fields.  Each table may have some
  215.     confidential information (like address/phone of customers). 
  216.     The sysop is able to hide certain fields from the search selection
  217.     screen by listing their names in HidStr.  In order to make them
  218.     completely invisible to the remote user, these fieldnames shouldn't
  219.     exist in PrnStr either.
  220.     IMPORTANT: the last character in HidStr should be a comma!
  221.  
  222.  
  223.  3.3  Table FileAreas:
  224.  ---------------------
  225.   Area:
  226.     The area name.  Apostrophes or double quotation marks not allowed.
  227.  
  228.   Directory:
  229.     The directory path related to the area name.  It corresponds to the
  230.     FileLocation field in table File.
  231.  
  232.   Securito: this field corresponds to field "Security" from table Users.
  233.     If it is zero, however, the Area is accessible to all users regardless
  234.     of their security code.
  235.     Not used in Lite, see section "Security".
  236.  
  237.  
  238. 4. MENUS
  239.  
  240.   Maxess' interface is menu-driven.  The user has to answer each menu
  241.   prompt by entering one of the options presented.  Here are some general
  242.   rules:
  243.   - Prompts terminated by a colon (:) or question mark (?) require
  244.     one-key input.  Usually this is the first letter of the command name,
  245.     no carriage return is needed.
  246.   - The angle bracket prompt (>) is answered by a string terminated
  247.     with carriage return.
  248.   - The user can cancel most of the prompts by pressing the ESC key
  249.   - Most of the prompts have syntax control and allow the user to
  250.     re-enter an incorrect answer up to three times.
  251.  
  252.  4.1 Main Menu
  253.  -------------
  254.   After successfully logging on and viewing the optional news file (NWS),
  255.   the Main Menu is presented as follows:
  256.  
  257.    ______ MAXESS Main Menu ______
  258.    <T>able selection
  259.       <S>earch in table xxx (conditional)
  260.    <M>essages
  261.    <F>iles
  262.    <U>ser setup
  263.    <G>oodbye
  264.       <A>bort MAXESS (conditional)
  265.    Your Choice : 
  266.  
  267.   <T>able selection     The user is prompted to choose one Access table 
  268.      on which subsequent queries with the <S> command will be
  269.      performed.  The tables are numbered and the user has to select the
  270.      corresponding number then press <cr>.
  271.  
  272.   <S>earch in table xxx    This prompt appears in the Main Menu if a table
  273.      has been already selected (see "Table queries")
  274.  
  275.   <M>essages   Invokes the Message Menu to Read, Scan or Send a message
  276.  
  277.   <F>iles      Invokes the File Menu with options to Scan, Download,
  278.      Upload files, change the transfer protocol and select file area.
  279.      Prompts for a file specification (like DOS' DIR command)
  280.      and displays a list of matching downloadable files.  A user can
  281.      cancel the file display by pressing N at the -MORE- prompt. Level
  282.      2 users can view any directory by including a path in the file
  283.      specification.
  284.  
  285.   <U>ser setup   Allows user entries (like name,address) to be updated
  286.  
  287.   <G>oodbye       Terminates the call.  The user's online time is
  288.      recorded in the Users table.  MAXESS then re-initializes the modem
  289.      and prepares to answer the next call.
  290.  
  291.  4.2 Mail Menu
  292.  -------------
  293.   The Mail Menu has two options:
  294.   <1> Scan/Read
  295.   <2> Send
  296.   ?
  297.   The default for option 1 is Scan.  While scanning messages, the user
  298.   is able to see only their headers (from, to, subject, date), but
  299.   not their content.
  300.  
  301.  SCAN/READ     The user is prompted to choose one of the following:
  302.    <T>oggle to Read (or Scan)
  303.    <F>orward
  304.    <R>everse
  305.    <N>ew and Unread messages
  306.    <S>elective retrieve
  307.    <I>ndividual msg# /Reply/Delete
  308.  
  309.    Forward :   Sequential multiple read.  Prompts for the beginning
  310.        message date and displays all accessible messages entered at
  311.        this date or after.
  312.  
  313.    Reverse :   All messages entered PRIOR to the selected date are
  314.        displayed.
  315.  
  316.    New/Unread :   Displays messages addressed to the user or to All
  317.        after user's last logon date.
  318.        
  319.    Selective : Selective sequential multiple read.  Messages might be
  320.        tracked by sender/recipient, date, subject and target string in
  321.        their content.  All accessible messages which match the search
  322.        criteria are displayed.
  323.  
  324.    Individual # : This option is activated only under Read.  The user
  325.        may read a message by entering its sequential number.  This is
  326.        also the only way to Reply or Delete a message.  Reply is
  327.        allowed if the user is the recipient of the message. Deletion
  328.        is possible if the user is the sender of the message.
  329.  
  330.   SEND: The user is prompted for the following:
  331.        To:                 (the intended recipient of the mail)
  332.        Subj:               (the subject of the mail)
  333.        Private Mail(y/N)   (Y for private, N for public)
  334.  
  335.        The user can then accept or re-enter the header information.
  336.        Once the header is accepted, the user is placed in a line input
  337.        mode. A line with a slash (/) represent the end of the message
  338.        content.  The user is presented with three choices:
  339.  
  340.        S)ave  A)bort  C)ontinue ?
  341.  
  342.        Save:       Append the message to the mail database and
  343.                    return to the Messages Menu.
  344.        Abort:      Erase the message and return to the Messages Menu.
  345.        Continue:   Return to input mode.
  346.  
  347.  4.3 File Menu
  348.  -------------
  349.  <1> Scan/Download files:  Files in the selected area(s) might be
  350.      searched by partial name, size, date, keyword in their description
  351.      and combinations of the above.  Filenames matching the search
  352.      criteria are listed and the user is offered the choice to select
  353.      some of them for download.
  354.  
  355.  <2> Download by name:  After a valid file specification is entered,
  356.      the message "Begin your transfer procedure" is issued.  Maxess
  357.      then waits for the user to download the file using the default
  358.      protocol.
  359.  
  360.  <3> Upload:   The user is prompted file name and a short description
  361.      of the file.  Maxess is then waiting to receive the file.
  362.      Files are placed in the upload directory which has been specified
  363.      during installation.
  364.  
  365.  <4> Protocol select:   The transfer protocol for the rest of the
  366.      session may be changed with this option.  To change the default
  367.      protocol use <U>ser setup from the Main Menu.
  368.  
  369.  <5> File area select:   A choice of file areas from table FileAreas is
  370.      displayed.  In Lite, only the first four defined areas will be shown.
  371.      In Maxess Retail only areas defined with the user's security code are
  372.      available for selection.  Zero (0) selects all authorized areas.
  373.  
  374.  
  375. 5. TABLE QUERIES
  376.  
  377.  5.1 Query definition
  378.  --------------------
  379.    To start a table query, the user has to select "S" (<S>earch in table)
  380.    from the main menu.  A list of table fields is displayed. The user 
  381.    may choose one or more field numbers separated by commas and hit <cr>.
  382.    By entering "*"(asterisk), all records from the table are displayed
  383.    at once.  By entering "+"(plus sign) all field numbers are selected.
  384.    If there is a selection, the user has to specify a search criteria
  385.    for each of the chosen fields.  Condition prompts might be ignored by
  386.    responding with <cr>. 
  387.    By default all conditions are combined with the AND logical operator,
  388.    unless the OR keyword is explicitly used.  Here is an example :
  389.  
  390.      Search in Files by:
  391.        1. FileName        3. Size
  392.        2. Location        4. Date
  393.      Enter numbers (ex. 1,3,4) or +/* > 1,1,4,4
  394.      (T) FileName [".TXT" OR
  395.      (T) FileName [".DOC"
  396.      (D) Date !<1/1/93@
  397.      (D) Date <7/1/93
  398.  
  399.    This query specification is translated as:
  400.    "Find all file-records with extension TXT or DOC and dates between
  401.    1/1/93 and 7/1/93 sorted by date".  Please notice the duplicate
  402.    selection of fields 1 and 4 and the explicit use of the OR keyword.
  403.    The "at" character (@) at the end of the first date condition
  404.    determines the sort order.  The sort order is always ascending.
  405.    There is a field type shown in parenthesis in front of each field
  406.    prompt.  Field types have conditional operators related to them:
  407.  
  408.       Field Type         Operators          Description
  409.       ----------         ----------------   -----------
  410.       (D)=date           = or < or >
  411.       (N)=number         = or < or >
  412.       (T)=text           = or < or > or [   [ means "contain"
  413.       (L)=logical        =T or =Y           T is "true"(or Y for "yes")
  414.                          =F or =N           F is "false(or N for "no")
  415.       any                !                  NOT (to be input first)
  416.       any                @                  SORT BY (to be input last)
  417.  
  418.    All operators are considered comparison operators except !(NOT), AND
  419.    and OR, which are logical operators.  The order of precedence for
  420.    the logical operators is : !(NOT), AND, OR.  According to this rule,
  421.    expressions with negation (!) are evaluated first, AND expressions
  422.    next and OR expressions are evaluated last.
  423.    Please,notice that operators are strictly related to their own field
  424.    types and shouldn't be used with other field types.  For instance,
  425.    operator =T for logicals (L) cannot be used with text fields (T).
  426.  
  427.  5.2 Query Output
  428.  ----------------
  429.    The result of a query is a set of records matching the query criteria.
  430.    The list of record fields to be displayed is in Prnstr, table TableList.
  431.    There are two query output formats - horizontal and vertical.  To use
  432.    the vertical format Prnstr has to start with a plus (+) sign.  The
  433.    vertical   format shows the fields from Prnstr on consecutive separate
  434.    lines.  This format is convenient for long Text or Memo fields.
  435.    Example:  Prnstr = +Name,State,Resume
  436.             Output:
  437.    --- Name :
  438.    John Doe
  439.    --- State :
  440.    TX
  441.    --- Resume :
  442.    ...here are displayed the lines of the Memo field 'Resume'...
  443.  
  444.    With the horizontal format, the fields are displayed in columns on one
  445.    line.  This format is more suitable for short fields (numeric, date).
  446.    Numeric fields are displayed right-justified, the others - left
  447.    justified.  Text and Memo fields are truncated to their width specified
  448.    in Widstr.
  449.    Example:  Prnstr = Name,State,Zip
  450.              Output:                 (field widths are defined in Widstr)
  451.    Name            State Zip
  452.    --------------- ----- -----
  453.    John Doe        TX    75086
  454.  
  455.  
  456. 6. SECURITY
  457.  
  458.     Security in Maxess is enforced through security codes.  Each user
  459.     has a security code assigned to him by the sysop after registration.
  460.     This code is stored in field Security of table Users.  Two or more
  461.     users can have the same security code giving them equal privileges.
  462.     The security code determines the ability to view and query certain
  463.     tables, to access file areas and to transfer files.
  464.  
  465.     In Maxess Lite, there are three security code groups:
  466.     Code group            Privileges    
  467.     ----------            ----------
  468.     0 to MaxNoFileXfer        table query, messages, NO file transfer
  469.     MaxNoFileXfer+1 to 9999   above + file transfer allowed
  470.     10000 to 32700            above + abort MAXESS allowed
  471.  
  472.     "MaxNoFileXfer" is a parameter chosen by the sysop during
  473.     installation.  It might be updated at any time with MAXESSIN.WAX and
  474.     saved in MAXESS.INI.  If MaxNoFileXfer is 0, file transfer privilege
  475.     is given to all users.  If MaxNoFileXfer is 32700, file transfer is
  476.     turned off.
  477.     Security of tables, fields and file areas is not implemented in Lite.
  478.     In Maxess Lite, the first table defined in TableList will be the only
  479.     one available for selection.
  480.  
  481.     In Maxess Retail, in addition of the above three privilege groups, the
  482.     security codes allow access to tables, fields and file areas.
  483.     Here below is a sample setup :
  484.  
  485.     Tables:      Users            TableList         FileAreas
  486.              ============   ===================    ===========
  487.     Fields:  Sec.  Usrnam   Sec.  Table  Prnstr    Sec.  Area
  488.              ----  ------   ----  -----  ------    ----  ----
  489.              1000  oneK     1000  T1     a,b,c     1000  A1
  490.                             1000  T2     e,f,g,h   1000  A3
  491.                                                    1000  A4
  492.              -------------------------------------------------
  493.              2000  twoK     2000  T2     f,h,e     2000  A3
  494.                             2000  T3     +w,u,v    2000  A1
  495.                             2000  T8     x,y,z
  496.  
  497.     The example shows descriptions for 2 security codes - 1000 and 2000.
  498.     Users with security code 1000 can select Access tables T1 and T2, and
  499.     see fields a,b,c or e,f,g,h as a result of their queries.
  500.     Users with security code 2000 can select tables T2,T3 and T8, and
  501.     file areas A3 and A1.  Notice also the different display of table T2
  502.     - for security code 1000 the fields shown will be e,f,g,h, while for
  503.     security code 2000 the fields shown will be f,h,e.  This approach
  504.     offers flexibility - the same table might be displayed differently
  505.     for users with different security codes.
  506.     Tables defined with security code 0(zero) are accessible to all users.
  507.  
  508.  
  509. 7. RUN-TIME ERRORS
  510.  
  511.     Run-time errors should not interrupt Maxess.  They are trapped and
  512.     recorded in the standard PROCOMM+ log file (PW.CLG).  The log file is
  513.     accessible by clicking the button "View Log File" on the main Maxess
  514.     window or from PROCOMM+ menu bar (File-- Connection_Log--Edit).  
  515.     Here is the list of run-time errors:
  516.  
  517.   Err#1: Error during SQL search.  The parameters of the search
  518.          are recorded to facilitate the debugging process.
  519.   Err#2: Action query error (similar to #1)
  520.   Err#3: No tables available for selection
  521.          The error is usually due to incorrect setup of TableList.
  522.   Err#4: File not found <filename>
  523.   Err#5: Insufficient disk space for upload on drive X
  524.          The upload drive specified in MAXESS.INI should have at least
  525.          200KB free storage space.
  526.   Err#6: Comma not allowed in fieldnames (table xxx)
  527.          Maxess do not allow commas in fieldnames
  528.   Err#7: Can't open message file
  529.          Due to lack of disk space
  530.   Err#8: Unable to open table xxx
  531.          The definition in TableList do not match a table from the database
  532.   Err#9: (reserved)
  533.   Err#10: Unable to hangup
  534.           System error, reset the modem and restart Maxess
  535.   PWerr:  Transfer aborted. Filename conflict
  536.           Generated by Procomm+.  The upload procedure consist of two steps.
  537.           First the user is asked to enter the name of the file he wants
  538.           to upload.  Then MAXESS checks the upload directory and the table
  539.           Files for possible matches with existing file names. If there is
  540.           no file with the same name, the user is authorized to begin
  541.           the upload.  At this time however, he might enter a different
  542.           filename.  If this new (unchecked) name matches one from the
  543.           upload directory, the existing file might get overwritten.
  544.           This is the reason to implement a second check at the time of
  545.           the transfer.  Error message #8 notifies the user about the
  546.           unfortunate mismatch between the two filenames he has entered.
  547.  
  548.  
  549. 8. LIMITATIONS AND RECOMMENDATIONS
  550.  
  551.   Both versions of Maxess - Lite and Retail, have these limitations:
  552.  
  553.   o  The total length of all table names defined with the same security
  554.      code in TableList should be less than 250.
  555.   o  The total length of all fieldnames of each table should be less
  556.      than 200.  When a table is selected, the program tries to read
  557.      all the fieldnames and their types directly from the database.
  558.      The result is sent back to Maxess as a string (255 chars max)
  559.      including fieldnames, types and separators between them.
  560.      If the table has too many fields or if their names are too long,
  561.      the maximum length of 255 will be exceeded.
  562.   o  No commas are allowed in fieldnames.  The comma is used in Maxess
  563.      as list separator and therefore shouldn't be part of the list
  564.      elements.
  565.   o  Filenames in table Files have to be unique across directories.
  566.      It isn't permitted to have files with identical names in two
  567.      different directories.
  568.   o  If you have an upload area defined in table FileAreas, the field
  569.      Directory should contain the directory path already specified during
  570.      installation in the UploadDir parameter of MAXESS.INI.  If these
  571.      two directory paths do not match, the users wouldn't find their
  572.      uploaded files.
  573.  
  574.   Recommendations:
  575.  
  576.   o   make sure the service table names in MAXESS.INI are accurate and
  577.       exist in the database 
  578.   o   do not rename fields in the service tables - Users,Messages,Files,
  579.       FileAreas and TableList
  580.   o   if you have a HidStr in TableList, terminate it always with a comma
  581.   o   to speed up Maxess:
  582.       a) create a small (~200KB) RAM drive
  583.       b) after installation, copy the files Maxess.INI, Maxess.WAX and
  584.          MaxessF.WAX (opt. Maxess.nws and Maxesspm.wax) to the RAM drive
  585.       c) run Maxess.WAX from the RAM drive (Procomm+ -- Scripts -- Run)
  586.  
  587.  
  588. 9. DIFFERENCES BETWEEN Lite AND Retail VERSIONS
  589.  
  590.   Maxess Lite has nearly the full functionality of the Retail version.
  591.   Nevertheless, certain restrictions apply:
  592.  
  593.      MAXESS Lite                          MAXESS Retail
  594.      ---------------------------------    -----------------------------
  595.   a) one table available for selection    more than one table to select
  596.   b) search on the first 5 fields only    search on all fields/tables
  597.   c) one user only                        support for multiple users
  598.   d) security partially enforced          security fully enforced
  599.   e) documentation in ASCII file          ASCII and HLP document files
  600.  
  601.   Explanation:
  602.  
  603.   a) In Lite, only the first table definition from TableList will be
  604.      available for selection to all users, regardless of their security
  605.      code.  In Maxess Retail, several tables may be defined with the
  606.      same security code.  They all will be accessible for remote query
  607.      by user(s) with matching security code(s).
  608.      Table selection is done by choosing <T> from the Main Menu.
  609.  
  610.   b) To start a table query in Maxess Lite, the user is presented with a
  611.      list of up to five (5) fields.  These are the first five fields of
  612.      the table.  If some of them are included in HidStr however, they 
  613.      are considered hidden and will not be displayed for selection.
  614.      Maxess Retail doesn't have such limitation and would display all
  615.      non-hidden fields of the selected table.
  616.  
  617.   c) A special script is included in Maxess Retail to ensure support for
  618.      additional users.  They all can dial-in simultaneously and work with
  619.      the same Access database.  The number of user lines is limited by the
  620.      available Windows memory and the number of serial ports.
  621.  
  622.   d) In Lite, security codes are used only to determine clearance for
  623.      file transfer and privilege to abort Maxess.
  624.      In Retail, security is enforced in table selection, query display and
  625.      file areas as well.
  626.  
  627.  
  628. 10. FUTURE ENHANCEMENTS
  629.  
  630.   Several new features are considered for implementation in the next
  631.   version of Maxess:
  632.   - updating tables;  according to their security code, users will be
  633.     authorized to remotely update/append records in Access tables
  634.   - query macros;  users will be able to execute their own predefined
  635.     query macros instead of entering the search criteria field by field
  636.   - ANSI support
  637.   - maintenance Access modules/forms/reports for the sysop
  638.  
  639.  
  640. 11. LICENSE AND WARRANTY
  641.  
  642.                        LICENSING AGREEMENT
  643.  
  644.   Licensed users are bound to the following licensing agreement.
  645.  
  646.   CONDITIONS:
  647.   Maxess is not a public domain software.  Users are granted alicense 
  648.   to use the program but HelgaSoft retains all rights thereto.
  649.   HelgaSoft hereby grants you a limited license to use Maxess Lite for 
  650.   evaluation purposes for a period not to exceed thirty (30) days.
  651.   If you intend to continue using the software and/or it's documentation
  652.   after the thirty (30) day evaluation period, you MUST make a
  653.   registration payment to HelgaSoft.
  654.   Users may not modify or reverse engineer the  software in any manner
  655.   for profit or otherwise.  Shareware distributors, including Bulletin 
  656.   Board Systems (BBSs), or users who might pass along HelgaSoft shareware
  657.   may not modify the contents of any files or bundles of files as
  658.   distributed by HelgaSoft.
  659.  
  660.   TERM:
  661.   The license to use this program is effective until terminated.
  662.   You may terminate the license by destroying all copies of this
  663.   program. It will also be terminated upon failure to comply with
  664.   any of the terms or conditions of this agreement.
  665.  
  666.   WARRANTY:
  667.   THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.
  668.   In addition, HelgaSoft specifically disclaims all warranties,
  669.   expressed or implied, including but not limited to implied
  670.   warranties of merchantability and fitness. In no event shall
  671.   HelgaSoft be liable for any claims for lost profits or any other
  672.   commercial damage, including but not limited to special, incidental,
  673.   consequential or other damage.
  674.   In no case shall HelgaSoft's liability exceed the license fees
  675.   paid for the right to use the licensed software.
  676.  
  677.   GOVERNING LAW:
  678.   This statement shall be construed, interpreted, and governed by
  679.   the laws of the state of California, USA.
  680.  
  681.   AGREEMENT:
  682.   By licensing Maxess Lite you agree to the above licensing agreement.
  683.  
  684.  
  685. 12. ORDERING AND SUPPORT
  686.  
  687.   The price to register Maxess Lite (shareware version) is $19.00.
  688.   The price to purchase Maxess (retail version) is $99.00.  
  689.   Please, indicate the floppy disk size (5.25", 3.5" or either size).
  690.   Registered users of Maxess Retail are provided with phone support.
  691.   Site licenses (5+ copies) are negotiable and qualify for a rebate.
  692.  
  693.   Payment must be made in US$ funds by personal check, cashiers check,
  694.   or money order.  Alternately, you can send international postal money 
  695.   orders in US dollars.  Please remit payment to:
  696.     Chris Gerdji
  697.     P.O.Box 371633
  698.     San Diego, CA 92137
  699.  
  700.   For all questions and comments regarding Maxess, please contact
  701.   HelgaSoft by
  702.  
  703.   Internet Email:   72103.1062@compuserve.com
  704.          US Mail:   HelgaSoft, POB 371633, San Diego, CA 92137
  705.  
  706.  
  707.  
  708. -------------------------------------------------------------------------
  709. APPENDIX A
  710.  
  711.         PHONE MONITOR program MAXESSPM.WAX
  712.  
  713.    You can activate the Phone Monitor program just by renaming the
  714.    file MAXESSPM.XXX to MAXESSPM.WAX and deactivate it by renaming
  715.    it back to MAXESSPM.XXX .
  716.    MAXESSPM allows you to use ONE telephone line for voice, answering
  717.    machine and data (BBS).  It detects a special sequence of calls
  718.    and rings and activates the host MAXESS program for one user session.
  719.    The special sequence to start remotely MAXESS is as follows :
  720.  
  721.    a) The user calls Maxess-host number, waits for 2 rings and hangs up
  722.       This first call might be placed from a regular phone or a modem.
  723.    b) The user waits for 10 seconds, but not more than a minute and 30
  724.       seconds and places a second (2nd) call from his remote computer.
  725.    c) Maxess responds, asks for username and password, completes the
  726.       session with the user and deactivates itself after the user logs
  727.       off the system.  MAXESSPM takes control again and begins waiting
  728.       for the next call.
  729.    Here below is a table illustrating the process:
  730.  
  731.    State  Phone          Computer
  732.    -----  -------------  --------------------------------------------------
  733.  
  734.    1.     (...)          Silence, MAXESSPM waiting first call
  735.  
  736.    2.     * * (10-89) *  The 1st call (2 rings) followed by the 2nd call
  737.                          (1 ring) after less than 90 seconds of silence.
  738.                          MAXESSPM stops and MAXESS is activated.
  739.                          User from remote computer connects to Maxess.
  740.                          After the online session is over, MAXESSPM returns
  741.                          to state 1.
  742.  
  743.    3.     * * (>90)      Silence is too long, expected 2nd call didn't
  744.                          occur within the 90 seconds time limit. Return
  745.                          to state 1.
  746.  
  747.    4.     * * *          Regardless of the state MAXESSPM is in, more
  748.                          than two consecutive rings means the current call
  749.                          is a voice call.  The answering machine will pick
  750.                          up the line at the third ring.  You can use
  751.                          MAXESSPM only if the answering machine setting
  752.                          is for 3 rings.
  753.  
  754.    rem: Phone states are    * = ring     (x) = silence for x seconds
  755.  
  756. -------------------------------------------------------------------------
  757. rem: To print this file with Notepad use Page Setup Margins:
  758.      Left=.5" ; Right=0"
  759.  
  760. * end maxess.txt *
  761.